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Section 1 -- Organization of Sources 


The Synclavier sources are kept in a tree of sub-catalogs. There 
are two primary trees: 


SYNSOU 


Contains Synclavier sources which have been modularized, 
especially including code for the top-level, screen manager, 
sample-to-memory and utilities. 


S¥NRSOU 


Contains Synclavier real-time sources which have not yet been 
modularized. 


SYNSOU 


The SYNSOU catalog contains many sub-catalogs which in turn 
contain the XPL source files. The currently defined sub-catalogs 
are: - 


DHOMOD - Printer output and hard copy 

D42MOD - Special output routines for DEC voice box 

DBUGMOD - Sequence debugger code (for internal use only) 

DIRMOD - Synclavier directory screens 

EDITMOD - Sequence editor screen 

ERRMOD - Synclavier error messages 

FILEMOD - File searching code 

GETMOD - Code for get.next.event 

GLOBMOD - Global variables needed everywhere 

GPRMMOD ~ A set of general buffered disk read routines 

LINKMOD - Miscellaneous routines 

LODMOD - Routines to talk to the direct-to-disk over SCSI 
MATHMOD ~ High precision math and time conversion routines 
MNOTMOD ~ Music notation screen 

MONOMOD - Routines for mono sampling playback 

MOUSEMOD ~ Module for mouse code 

OPTMOD - Optical disk screen 

PARMMOD ~ Module for processing Synclavier parameters 

PATCHMOD - Sound file patch screen - connects sound files to keys 
PLOTMOD = Plot library 

PMEMMOD = Old (16 bit) poly memory interface, now calls polymod 
POLYMOD - Module with code to access poly memory 

RECMOD ~ Recorder sereen (another sequence editor) 

ROUTMOD ~ MIDI and multi-channel routing display screens 
SCRNMOD ~ Screen drawing primatives (draw, box, etc...) 

SEQMOD - Sequence manipulation primatives to operate on data str. 
SMGRMOD - Module for sereen manager 


Me ME eee eee aoe oe oo 
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OTHER CATALOGS 


There are several other top-level catalogs which contain files 
needed to compile the Synclavier software: 


SYNRDCLS = External declarations for real-time modules (SYNRSOU) 
SYNAUXS ~ Auxiliary literals used by only some modules 

SYNLITS - Basie common literals for the Synclavier 

SYNMODS - External declarations for each module in SYNSOU 
SYNMAINS - Main programs and do files for Synclavier compilations 
SYNCOMS - Compilation’*flag sources for different system versions 


“em mM mh om 


There are also several catalogs which contain relocatable 
binaries for the Synclavier software: 


# SYNLIBS - Relocatable binaries for each module (from SYNSOU) 

SYNTLIBS - Relocatable binaries for terminal screens (from SYNSOU) 

# SYNRLIBS - Reloecatable binaries for Synclavier real-time modules 
(from SYNRSOU) 
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Section 2 -- Internal Memory 


There are several different kinds of memory in a Synclavier 
system. The ABLE computer has memory directly available to the 
processor known as INTERNAL MEMORY. There is additional memory used 
for storing sequences, timbres and other data structures known as 
EXTERNAL MEMORY. A system may also contain POLY MEMORY, used 
primarily for storing sampled sound data. 


* 


OVERALL STRUCTURE 


INTERNAL MEMORY is that which is directly available to the CPU 
for storing instructions and data. Information stored in INTERNAL 
MEMORY is accessible more quickly than other memory in the system. 


‘The 16 bit architecture of the ABLE processor limits the amount of 


INTERNAL MEMORY to 64K words. The structure of INTERNAL MEMORY looks 
like: 
INTERNAL MEMORY 
fe 
LOC 0 | STARTUP CODE: "PCI TO LOAO" 


' 
4 
; 1 
C#CONTAB = LOC 1 } PTR TO CONFIG TABLE [oot 
| mana nann mannan nanan naan na= —! | 
| BALANCE OF STARTUP CODE 
(FORMAT DESCRIBED |--~------------------------- —! | 
IN :=-XPL:SYSLITS) | CONFIGURATION TABLE [<mmn+ 
Poor en gt ee ee ne gee fast eee ——| 
| STRING & DATA CONSTANTS j} 
\----------- sees} 
H PROGRAM CODE H 
(SIZE OF LARGEST  !---~----------------------- =! 
SWAPPING PROCEDURE) | SWAP AREA H 
[--------------- 
VARIABLES 
[--------------- ! 
STACK 
amar Ca a re mare CRI a + 
H FREE (*) | NOTE BLOCKS H 
(TOP=1024) -----~ Se | ana ater ennerne mene —! 
1 OVERLAY ROUTINE } PARTIAL BLOCKS ; 
(TOP=512)-----~- > | pee nn nnn n nnn nen enn | ae + 
| SYSTEM STATE VARIABLES i 
(TOP = 60K-1) 60K!---~~--~---~------------—-— 
H BOOTLOAD ROM i 
OK pon aan ne nn nn ern ere nme ee + 


(*) NOTE: WHEN RUNNING THE SYNCLAVIER PROGRAM, THIS SPACE FOLLOWING THE 


STACK IS USED FOR NOTE BLOCKS AND PARTIAL BLOCKS. THE "OVERLAY 


ROUTINE" IS SWAPPED OUT TO MAKE ADDITIONAL ROOM FOR THEM, THEY ARE 


ALLOCATED AT RUN-TIME OFF OF THE "HEAP" BY THE SYNCLAVIER PROGRAM. 
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If an XPL procedure is declared to be a swapping procedure it is 
not always resident in INTERNAL MEMORY. The compiler automatically 
takes care of allocating a place for it to be loaded in EXTERNAL 
MEMORY. When it is called for execution, it is copied for you to the 
“SWAP AREA" in INTERNAL MEMORY and program control is passed there. 
When another procedure is swapped in to the "SWAP AREA", the previous 
routine is over-written. Only the code is swapped in; the values of 
any static variables are preserved in INTERNAL MEMORY across swaps. 


Most swapping procedures in the Synclavier code are declared to 
be "SWAPABLE" [sic]. This is a literal which translates to 
"RECURSIVE SWAP" for the XPL compiler. It means that variables 
default to AUTOMATIC (created on the: stack) rather than STATIC (in 
internal memory). 


The "SWAP AREA" reserved for a given program is the size of the 
single largest swapping procedure declared by that program. See the 
section in the XPL manaual on "Swapping Procedures" for more 
information on the subject. 


The Synclavier software is loaded into the PROGRAM CODE and SWAP 

AREA portions of INTERNAL MEMORY for execution. Like any executing 
program, it also uses the STACK and VARIABLES segments. QUEUES of 
pending notes are built in the NOTE BLOCK and PARTIAL BLOCK areas 
which are described in more detail below. 


QUEUES 


NOTE and PARTIAL BLOCK structures for notes which are currently 
active, or will be very soon, need to be in INTERNAL MEMORY for the 
sake of real-time speed of data access. Most of the sequence and 
timbre information is stored in EXTERNAL MEMORY, because it is much 
larger than INTERNAL MEMORY. The Synclavier software looks ahead 
80msec in real time and builds QUEUES of NOTE BLOCKS which in turn 
point to zero to sixteen PARTIAL BLOCKS in INTERNAL MEMORY. 


There are several QUEUES present in INTERNAL MEMORY. Each one 
has a global pointer to the start of the QUEUE which is a linked list 
of NOTE BLOCKS. The currently defined pointers and their QUEUES are: 


NOTELIST -> First NOTE BLOCK in the ACTIVE NOTE LIST QUEUE 
KBDLIST -> First NOTE BLOCK in the NEW KEYBOARD NOTES QUEUE 
SEQLIST -> First NOTE BLOCK in the NEW SEQUENCE NOTES QUEUE 
SEQLAST -> Last NOTE BLOCK in the NEW SEQUENCE NOTES QUEUE 
TIELIST -> First NOTE BLOCK in the TIED NOTES QUEUE 

TIELAST -> Last NOTE BLOCK in the TIED NOTES QUEUE 

NFREEP -> First NOTE BLOCK in the FREE NOTE BLOCK LIST 
PFREE -> First PARTIAL BLOCK in the FREE PARTIAL BLOCK LIST 


Ce 
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QUEUE STRUCTURE 
NOTE BLOCK PARTIAL BLOCK PARTIAL BLOCK... 


| PTR TO NEXT NOTE { 4->; FORWARD PTR iat FORWARD PTR 
' BLK IN THIS QUEUE | | |—------------------- {| en en ne 
ocala teiasatnaaenenatamnerenatates oat ae OTHER DATA H i OTHER DATA 
i OTHER DATA tL Sees erent i. * See mete meet 
| EE SPE ee 
: PTR TO PARTIAL BLK {~+ H 
| area can ce =| fo ae er en ar a pc > 
H OTHER DATA i * UP TO SIXTEEN OF THESE 
POPS See em reer mewn + PARTIAL BLOCKS MAY EXIST... 

NOTE BLOCKS 


NOTE BLOCKS are allocated and placed on one of the QUEUES just 
described. In order to use the offsets defined for a NOTE BLOCK (eg: 
NFPTR, TIMBRE...), you must set the pointer NPTR to the start of the 
NOTE BLOCK you wish to access. 


NOTE BLOCK (27 WORDS) 


:SYNLITS: QUELITS 
NPTR-->} FORWARD PTR 1 NEPTR 
| TIMBRE NUMBER | TIMBRE 
| TRACK NUMBER | TRACK 
ea DATA | 
| RECORDING PTR WORD | REGH 
| RECORDING PTR SECTOR {RECS 


PO LE SS RE ES ES A SD SY AD RE SO NL CON NY 


PARTIAL BLOCK LIST PTR ; PTLST 


PARTIAL BLOCKS 


A chain of zero to sixteen PARTIAL BLOCKS are allocated and 
pointed to by the NOTE BLOCK just described. A note may have one to 
four partials by itself. This expands to a maximum of sixteen 
possible PARTIAL BLOCKS when you take the features "chorus" and 
"partial chorus" into consideration. In order to use the offsets 
defined for a PARTIAL BLOCK (eg: PFPTR, PLOG...), you must set the 
pointer PPTR to the start of the PARTIAL BLOCK you wish to access. 
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PPTR-=>; 
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PARTIAL BLOCK (80 WORDS) 
:SYNLITS: QUELITS 


Se ek HE SD SO DE SS SO SN A NE ONE EE SS ON SE A RE OE 


FORWARD PTR 


A CO SO CO EE SND NE SN SSE SR SN EO OS 


CHORUS PTR 


VOLUME ENVELOPE Q FORW PTR 


A CO ON SS A ND SD ON EE SD ENNY ND AD nD SD HE HN on ND SD 


VOEUME ENVELOPE Q BACK PTR 


FM ENVELOPE Q BACKWARD PTR 


DECAY FORWARD PTR 


8 A LS A OS SAD OD HE SY OD SS INS SS OS CNR SS HD So WR ORE SE 


=i0< 


| PFPTR 


| PLOG 


| EOF 
| EQB 
TOF 
| 108 
FOF 


| FQB 


| GFPTR 
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Section 3 -- External Memory 


External memory is not directly addressable by the ABLE CPU. It 
is accessed as a device is through the use of XPL "read" and "write" 
statements. Because it is addressed using two registers totalling 24 
bits, it is possible to have a maximum of 32 megabytes of external 
memory . 


External memory is divided into SECTORS of 256 words each. Two 
address and two data “registers are used to access it. An address 
register "MAM" gives the sector number (Memory Address 
Most-significant). A second address register "MAL" is an offset into 
the selected sector (Memory Address Least-significant). Once an 
address is specified in "MAM" and "MAL", data (a 16-bit word) is read 
or written from the "MD" register. A fourth register "MDI" may be 
used to access data and auto-increment the MAM and MAL pointers to 
the next seqential word, crossing sector boundries if necessary. 


EXTERNAL MEMORY 
MAM 


MAL = Offset -->} SECTOR-0 (256 words) 


"wou 


! Se Te ee ED CONS ONS DE OR TE ER NE OE SE OD ED ae we OER UY SR Se cue me CD ee eD 


{ 
H SECTOR-1 (256 words) 
H aa a a cave a aie i 


H SECTOR-2 (256 words) 


The values of MAM, MAL, MD and MDI are defined in 
:SYNLITS:GLOBLITS. The following example reads the first 1024 words 
of external memory into an array in internal memory, and leaves zeros 
in place of the data in external memory: 


2 /* Point at the first sector */ 
/® No offset into the first sector */ 


write (MAM) 
write (MAL ) 
do i=0 to 1023, | 
array(i) = read(MD); /*® Read data word #*/ 
write(MDI) = 0; /* Clear location and point at next */ 
end; 


OVERALL STRUCTURE 


When the Synclavier program is running, the lower addresses of 
external memory are used to store sequence, timbre and note 
information for the user. Swapping procedures are stored in the 
upper addresses. Swapping procedures are allocated at compile time; 
all other structures shown here are built at run-time. 


The major data structures begin at a pointer, named ???.PTR with 
a length of ???.LEN. Note that the .LEN value is the current length 
of real data stored in that particular area. There is often a "gap" 
maintained at the end of each data structure so new entries can be 
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all... 


made without shuffling everything around. Usually the largest "gap" 
is kept following the NAH information to allow the sequence to grow 
quickly. As space becomes tight, the gaps are reduced - to zero if 
necessary. . 


EXTERNAL MEMORY 


PSS Riera mie iin rere rien amon rent + 
SECTOR 0 } ALL ZEROS H 
BAS, PTR==> | --n-----2 nn --n- nnn n nnn nnn 
BAS. LEN | SEQUENCE BASE SECTORS (2) } 
PAR, PTR--> | -nen tana nnn nnn anne nnn ane —! 
PAR.LEN i TIMBRE PARAMETER AREA H 
NAH, PTR-—> | --=------------=--------=--=- 
° H NOTE AREA HEADER (NAH) i 
NAH.LEN !--------------- 
. i TRACK HEADER SECTORS AND i 
: H NOTE LIST SEGMENTS 
. H Fi eye! ee oy fo oe SY SE hae ee a H 
° H FREE SPACE H 
BNK , PIR--> | ---------~-- nnn nnn nnn = ! 
BNK.LEN i TIMBRE BANK { 
INF , PTRa=> | -eenn naan nnn nnn nnn nn anne 
INF. LEN | MUSIC PRINTING SEQ INFO j} 
TIM. PIR--> | ----------==-=--==----====-=- ! 
‘TIM. LEN H TIMBRE HEADS 
TRD, PIR==> | ann na n---nn nnn nnn nnn nnn nnn a= 
TRD. LEN | TIMBRE TERMINAL DISPLAY INF } 
EXAMOUNT ==> | ---n=-a--nnnnnnnnnnnnannnn nnn ! 
MSFIRST==> | MONO SAMPLING BUFFERS H 
MSMA X=-> | ---eennannnn nnn nnn nn nnn nnn 
H LOOK UP TABLES i 
1 en a a a a a a t 
1 ALL SWAPPING PROCEDURES 1 
: ct edi ci ss oh os ih les ci i ie ci am i et seo ots sn | 
H RESERVED BY THE SYSTEM H 
ee ot ae ee AEN OER re ay oe ee ee + 


The next diagram shows the relationship between the track header 
structures. The NOTE AREA HEADER is a single sector containing up to 
256 pointers to TRACK HEADER SECTORS (relative to NAH.PTR). There is 
also a TRACK LOOK UP TABLE in the LOOK UP TABLES area which has the 
same structure, but is 256 absolute pointers to the TRACK HEADER 
SECTORS. 


Each TRACK HEADER SECTOR has several pointers into the NOTE LIST 
SEGMENT for that track. They include pointers to the start of the 
NOTE LIST SEGMENT, to the currently playing note, and to the start 
and end of loops. The individual structures are described in more 
detail later. 
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TRACK HEADER STRUCTURE 


NOTE AREA HEADER or 


TRACK LOOK UP TABLE TRACK HEADER SECTOR NOTE LIST SEGMENT 
een aee SSS ae + sR IRS ach ai saat ear Lice, a, is a se BER Siem + 
H SECTOR # j-~->; PTR TO NOTE LST SEGi—->} PTR: NEXT NOTE LST } 
| anennn nn nnn nn nnn te ee ee —| 
H SECTOR # H } OTHER DATA H | PTR: PREV NOTE LST | 
| manna nana nena a | aetnennnmnnnmnnnn —! 
i SECTOR # : ; CURRENT PLAY PTR j{-->; OTHER NOTE DATA i 
| aon a ee 1 | 
H ° 1 7 4 OTHER DATA { H . i 
: en ee Dood 
H ° H } OVERALL LOOP PTR {==>} ° 
fonca nen ne nnn nnn $ fee eee mene nnnnemen rf : 
; IND LOOP START PTR j-->} . H 
| aon nnnnnnnnnnmennnn —! . 
| IND LOOP END PTR {==>} . H 
H eg eS ee H H e i 
H OTHER DATA 1 H . H 
a ae aE f Ip SRS Sena ates tea + 


The next diagram shows the relationship between the timbre data 
structures. The TIMBRE LOOK UP TABLE. is a single sector in the LOOK 
UP TABLES area containing up to 256 absolute pointers to TIMBRE 
HEADS. Each TIMBRE HEAD has several pointers into the TIMBRE 
PARAMETER AREA for that timbre. The individual structures are 
described in more detail later. 


TIMBRE STRUCTURE 


TIMBRE LOOK UP TABLE TIMBRE HEAD TIMBRE PARAMETER AREA 
Fleet aaetatetatteteteted + oS tase eet fo PR rr een + 
H SECTOR # i~==>} VOLUME LEVEL 1 +>} BASIC INFO #1 H 
| Soe n ewe H | Te me ene come mnee Ht Hill lontatatatenatatatatatebatanataeanene 
! SECTOR # i H #1 PARTIAL PTR im+ | TIMBRE FRAMES #1 } 
{Pam een mene 1 | te eee ene H | emcee 
i SECTOR # : | #2,3,4 PARTIAL PTR | +>} PINFO BLOCK #1 1 
{See an ae ct H | Moet ene ne nese nen ann Hi Sl foscatetntatadeinhataieteiatadetntene H 
H ° i } #1 PINFO PTR inm+ H 
H ; t | ee et tn a a a H ; (ABOVE CAN REPEAT $ 
H ° H i OTHER DATA H ; UP TO FOUR TIMES) ! 
poten enn + 1 iacaateteataetatentetenereneteetetetaren H i i 
: MISC PTR ime | H 
J Serene ee ee a HI Slt Lecntetetatatatatatnietaataeneratatas H 
H TINFO PTR =>] TINFO BLK i 
 facubeianeieatanataebatataenatenateed Ht ft Rocelatetetetebatabenenannietetetatere 1 
H OTHER DATA ee MISC AREA H 
Fatah aiettatteeateteetetetated fo pO eee nee + 
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The following diagrams are an expansion of the previous general 
pictures of external memory data structures. No attempt is made to 
include every piece of data. Rather, the general types of 
information and their relative locations are shown. Pointers to 
other data structures are included so the inter-relationships can be 
seen. 


It is worth noting that many of the pointers used in external 
memory are RELATIVE to a base pointer for the data structure 
containing them. This is so that information in external memory can 
be shuffled around without having to recalculate all the pointers. 
Only absolute pointers bécome invalid. 


SEQUENCE BASE SECTORS 


SEQUENCE BASE SECTORS contain miscellaneous information and 
pointers to timbres, notes and music printing. This information and 
the relative pointers are only updated when about to write a sequence 
out to the disk. They are not kept up to date during run time. 


SEQUENCE BASE SECTORS 


:SYNLITS: THDLITS 
BAS {PIR SS pmeseee cere y 
1 ' 
e { i 
° H GENERAL SEQUENCE INFO i 
' 1 
2 ee 
e ! RELATIVE PTR TO BASE SECTOR { SEQ.BAS 
BAS LEN | -=enenwnnenn--—— aaa “a 
* ' REL PTR TO TIM PARAM AREA ;{ SEQ.PAR 
° H aR am a aad ca aol RS aT ears H 
. ‘ RELATIVE PTR TO NOTE AREA { SEQ.NAH 
° 1 ee i i 
° ! RELATIVE PTR TO MUSIC PRINT {| SEQ. INF 


TIMBRE PARAMETER AREA 


The TIMBRE PARAMETER AREA is where the partials are stored for a 
timbre. A timbre can have up to four partials. Each partial starts 
out with a 46 word block (or just a word "SUP" (-2) if the partial is 
not used). Following the 46 word block are some optional blocks of 
data which are variable length. All four partials must be specified, 
or marked unused with "SUP", A good concise example of some code 
which steps through this structure may be found in the procedure 
"FIND.TIMBRE" in the file :SYNRSOU:03-PRIM: 131-SDF1. 
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TIMBRE PARAMETER AREA 
:SYNLITS: PRMLITS 
PAR SP IR = 2 peer ee own nr sre ae eee eee + 
| BASIC PARTIAL INFO (46 WDS) { 
46=NUM.PARAMS {| OR A SINGLE WORD "SUP" (-2) {| P.* 


t 
1 
OPTIONAL{ | "MOR" (=1) i 


{}--------------- 
TYPE{ | "Tr TYPE" (0) H 
{|--------------- 
CLEN{ } "LEN. TIMB.FRAME" (172) H 
{ t--% fe Ses vce ee aa eat mms. a a Fal i 
{ | TIMBRE FRAME (172 WORDS) | NOTE: THERE CAN 
Ls - 8 SYSTEM WORDS ; BE MORE THAN ONE 
oe - 12 PARAMETERS : TIMBRE FRAME OR 
{ j - 24 COEFFICIENTS ; PATCH TIMBRE FRAME 
{5 - 128 WAVE TABLE ENTRIES { IN A PARTIAL. 
pr ee ee ge ae ce ea ee ee H 
OPTIONAL{ | "MOR" (=1) 1 
{|--------------- 
TYPE{ | "PT. TYPE" (1) H 
{{--------------- 
CLEN{ | “PT. LEN" (48) i 
— {jee eee ee eee 
{ ; PATCH TIMBRE FRAME (48 WDS) } 
| panama nnn nanan nnn nnn n= --! 
{} "PINFO" (=3) H 
OPTIONAL{ |- -------------- 
PINFO.LEN{ {| PARTIAL INFO (32 WORDS) ; PI.* 
a areata ee air aa ahaa + 
NOTE: THE ABOVE REPEATS 4 
TIMES (ONCE PER PARTIAL) 
AND THEN IS FOLLOWED BY: 
3 neater ee enon see a ces en mem enen momen + 
{ } "TINFO" (=-4) H 
OPTIONAL{ |--------------- 
TINFO.LEN{ {| TINFO BLOCK (96 WORDS) ; TI.* 
sma dh sik ens ies e's cn Sn eles el cue bh lek ih aly ted hea att 
H "MISC AREA" (8 WORDS) H 
a a a + 


NOTE AREA HEADER 


The NOTE AREA HEADER is a single sector containing 256 pointers, 
one for each possible track. Each pointer is a sector number, 
relative to NAH.PTR, pointing to the track header sector for that 
track. If there is no active track corresponding to a given pointer, 
it is zero, The first two tracks are reserved for the keyboard and 
split keyboard respectively. 
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NOTE AREA HEADER (NAH) 
:SYNLITS: THDLITS 
NAH PLR =D geese rae ene eee saan senm n= + 
H SECTOR NUMBER i 
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TRACK HEADER SECTOR 


One TRACK HEADER SECTOR exists for each of the active tracks. It 
is pointed to by the NOTE AREA HEADER data structure. Each TRACK 
HEADER SECTOR is exactly one disk sector in size. The sector 
contains miscellaneous information for the track such as loop and 
play pointers and real-time effects. There is also a pointer to the 
first NOTE LIST SEGMENT which is the first block of actual notes on 
the track. 


- There is a linked list of tracks, sorted by the next event to 
occur in real time. The head of this list is a global pointer, 
"NEXT. EVENT.QUEUE" which points to the TRACK HEADER SECTOR with the 
next up-coming event. Within each TRACK HEADER SECTOR are two 
pointers, THD.NEVF and THD.NEVR which are forward and reverse 
pointers to the next TRACK HEADER SECTORS in this list. As time 
advances, new TRACK HEADER SECTORS are appended to the end of the 
linked list. As an event occurs, the top track is removed from the 
head of the list. 
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TRACK HEADER SECTOR 
:SYNLITS: THDLITS 


PTR TO START OF NOTE LIST | THD.FOR (*) 


EE OS EO A A ON OE CN PE SNE A OE SO NE ON YS EE 


i 
1 
REVERSE PTR - ALWAYS ZERO | THD.REV 
i 
' 


TRACK NUMBER ; THD.TRK 
FORWARD PTR TO NEXT EVENT | THD.NEVF 


0 2 em Oe SE FE NED SR HD A NE A OO a TN OH 


‘REVERSE PTR TO NEXT EVENT | THD.NEVR 


A OO A CA NE NE A EE DE SO SE a A ND SO NR a 


1 

' 

H 

H TRACK 

t 

i 

THD.SEC (*) 


MORE DATA FOR 
THIS TRACK 


i 

! 

' 

' 

' 

' 

? 
CURRENT PLAY PTR ~- WORD # {| THD.WRD (*) 

! 

i 

i 

i 

' 

' 

{ 

' 

{ 

! 
OVERALL LOOP PTR - WORD # | THD.LP.WRD (*) 
THD.LP.SEC (*) 


MORE DATA FOR 
THIS TRACK 


THD.ILS.WRD (*) 
THD.ILS.SEC (*) 


tei 
= 
oO 
(} 
as) 
Sz) 
= 
i=) 
tm 
= 
wy 
8 
©] 
0 
a | 
~ 

‘ 
~ 
= 


i 
' 
MORE DATA FOR H 

THIS TRACK i 


oe tt A ENE ES SG SE I A I Ow 


IND LOOP END PTR - WORD # {| THD.ILE.WRD (*) 


Cm 8 0 TS I HO AO A SN A EE END IO ANN SS YO ST NN 


{ 
1 
IND LOOP END PTR - SECTOR # {| THD.ILE.SEC (*) 
eR DE HE A DS TE OD CE NN ND a SS A SY ED HE SO : 

MORE DATA FOR 

THIS TRACK H 


eer i et re 


(#) INDICATES A POINTER INTO THE NOTE 
RECORD LIST FOR THIS TRACK 


NOTE LIST SEGMENT 


A NOTE LIST SEGMENT is a linked list of sectors containing note 
records. Each sector contains a forward and reverse pointer and up 
to 126 2<word note records. Special format note records may also 
exist which are 4 words long. Note that the pointers to the first 
and last note records point at actual data. NLS.FIRST and NLS. LAST 
define the size of the block which can POTENTIALLY hold note records. 
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NOTE LIST SEGMENT 
:SYNLITS: THDLITS 


PTR: NEXT NOTE LIST SEGMENT {| NLS.FOR 


pape aaa a 
7 TRACK NUMBER | NLS. TRK 
i PYR TO FIRST NOTE RECORD | NLS.FP 

Cae ae jane 
+>! (FIRST) 3 NLS.FIRSTL 
! NOTE RECORDS 
(LAST) 7 NLS. LAST 
tuuyt FLAG AT END (-1) ‘| NLS.EOS 

200 ramen sn ae rn capes ca em cnr ane cam oem cn em a ene ae een A + 


NOTE RECORDS 


NOTE RECORDS contain information about notes to play, including 
starting time, duration and key to play. They are also used to make 
changes in real-time effects which can effect some or all of the 
currently active notes. 


There are three general rules used in determining the format of a 
NOTE RECORD: 


1. If the LSB of the first word is set, the NOTE RECORD length will 
be 4 words, else it will be 2 words. 


2, If the MSB of the first word is set, the NOTE RECORD is in 
"alternate format", if clear it is in "normal format". When in 
alternate format, the next 4 upper bits of the first word are 
used to indicate what type of "alternate" record it is. 


3. For all 4 word records, the lower 6 bits of the last word must be 
"62" (VEL.NOTE). This is necessary to determine the length of 
the record when stepping through in reverse order. 


A NORMAL FORMAT 2 WORD RECORD is the simplest NOTE RECORD. It 


represents notes in the range of 12 to 72 (C1 to C6). The velocity 
is assumed to be full value (RTE.MAX = 255). 
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NOTE RECORD (NORMAL FORMAT, 2 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT-->!} O{HI-DUR{START TIME DELTAiO { 
BITS IN FIELD-->! Gh hes vous Ocanscevn V3 


2 AE AE SO SOR HEE SE AONE ND OD A NE SNES A 


{ 
LOW DURATION | KEY NUMB 


i 

I 

1 

i] 

! 

i ' 
' i 
i ' 
! ' 


val aca ela ka eae (eee OKO RS 


A NORMAL FORMAT 4 WORD RECORD is used to represent keyboard notes 
0 to 84 (CO to C7). Thé full range of note velocity values may also 
be stored in this record. The duration and starting time fields are 
the same. 


NOTE RECORD (NORMAL FORMAT, 4 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT-->! O'HI-DUR!START TIME DELTAi1 | 
BITS IN FIELD—>; “i bac pe Poe | H 


| ee Se SE SO SO SS ON ND SS NS NN 


1 

! 

LOW DURATION ; KEY NUMB { 
t 

1 


sagas Obyenandenl nie Oeess 


i 

” SHTTCH/FLAG BITS | RTE DATA | 
i 

! 


Rs: Pe ere ne Peers Pere 


i 1 
! VOLUME/OTHER {RAISE/LOW; 62 | 
' ' 
i \ 


ees, Snes Peer ree rn rss 


An EXTENDED REST note record is needed to specify a rest of 
longer than 1023 milliseconds in a single note record. 


NOTE RECORD (ALT FORMAT: EXTENDED REST, 4 WORDS) 
:SYNLITS:SYNCLITS 


‘START TIME DELTA}1 | 


Jie eeaee (lees eeuaer er 


DATA PRESENT=->; 11 
BITS IN FIELD-->; 11 


mk A A AE AOR ON RS OG SO NL NE GS cm SR 


i MOST SIG START DELTA 
! 
i 


igia'e-e'e:d Waleed lols nae ei eieiere ee 


=O 


LEAST SIG START DELTA 


Neoicleeewieeee [Owes oeeieeis a ee's 


UNUSED FIELD ; 62 
i 


ceieasecwe’d Dec eneeceeee ds 2 
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An INDEPENDENT LOOP START record is used to mark the start of a 
loop present in this track independent of other tracks. Once a track 
has entered a loop, it will continue playing between the start and 
end loop records without exiting the loop. Only the first word of 
the 4 word record contains any useful data. 


NOTE RECORD (ALT FORMAT: INDEPENDENT LOOP START, 4 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT-->! 1} 1 {LOOP START TIME DLT;1 ; 
BITS IN FIELD--> | Vile lutecwwann (es koasaeu len 
' 

1 


OE A HS AE CAD CO AE A HY A DO SO I ON OI NS 


UNUSED FIELD 


Wee ae Riisiatae 10d aie ole eee eee ate 


UNUSED FIELD 


wivleh aie eleid dice 1O wise eieb0.80'bee 6 


CaCO A AE A SO OS SE SS A NN ND CEN IRE TR A NS 


1 UNUSED FIELD H 
' i 
i 1 


ei Maas eS.8 lUea eee es eerste 


An INDEPENDENT LOOP END record marks the end of valid note 
records for this track. As time continues to advance, the track will 
loop indefinitely back to the INDEPENDENT LOOP START record. 


NOTE RECORD (ALT FORMAT: INDEPENDENT LOOP END, 4 WORDS) 
:SYNLITS:SYNCLITS 


DATA PRESENT-->{ 1} 2 {LOOP END TIME DELTAi1 | 
BITS IN FIELD~-—>} 1 i o4. H eesocen oe WOsediacesc H 1. H 
: i ' i 


UNUSED FIELD 


oeelge twee ece lOeesee Case ee 


UNUSED FIELD H 
! 
t 


eh ceil Bel O ei aware aera a araie 


UNUSED FIELD 


‘ 
1 
1 
‘ 
{ 
1 
1 
1 
1 
i 
i 
1 
1 
i Ut te poue Jee de ewe ees neOe 


OV 
NM 


For more information on the exact format of the data in each of 
the above fields, refer to the definitions in :SYNLITS:SYNCLITS or to 
Tim Schaaff's memo "SYNCLAVIER NOTE RECORD FORMATS", 
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TIMBRE BANK 


A TIMBRE BANK is a temporary storage area used to hold a bank of - 
timbres read in from the disk. The format of the TIMBRE BANK is the 
same as the TIMBRE PARAMETER AREA (see earlier description above). 
When the user selects a timbre bank, all the timbres in it are copied 
to this area. Then when a specific timbre is picked, it is copied to 
the TIMBRE PARAMETER AREA. 


If the entire bank will not fit in external memory, the system 
waits for the user to select a specific timbre. Then, that one 
timbre is copied directly from disk to the TIMBRE PARAMETER AREA. 
The size of the TIMBRE BANK is often zero, either because no new 
partials are being selected, or because the space was needed for 
other things (eg: active sequence and partial information). 


MUSIC PRINTING SEQ INFO 


The MUSIC PRINTING SEQUENCE INFORMATION is a block of data which 
is defined by and maintained for the music printing software. The 
format is considered "unknown" by the Synclavier software. A pointer 
to this block is maintained (INF.PTR) and the data is shuffled around 
to accommodate other areas as necessary. 


TIMBRE HEADS 


The TIMBRE HEADS area is made up of sectors containing 
precomputed information for the basic timbre and pointers to partial 
data in the TIMBRE PARAMETER AREA. All of the pointers into the 
TIMBRE PARAMETER AREA are relative to PAR.PTR. 


The TIMBRE HEADS area may also contain KEYBOARD LOOK UP TABLES. 
These are used when different sounds are mapped to various keys on 
the keyboard (eg: bass drum on middle-C, snare drum on middle-D, 
etc...); this is known as "patching". Each of the four partials for 
a timbre may be patched through a KEYBOARD LOOK UP TABLE, or they may 
not. The pointers in the TIMBRE HEAD are zero if no KEYBOARD LOOK UP 
TABLE exists for a partial; if non-zero they are relative to TIM.PTR. 
In the Synclavier code, sometimes the KEYBOARD LOOK UP TABLES are 
also refered to as the KEYBOARD PATCH LIST. | 
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TIMBRE HEAD 
:SYNLITS: TIMLITS 


TIM, PIR=->4-------- nonin nnn nnn 


| VOLUME LEVEL | TIM, VOLUME. LEV 
{PARTIAL PERS (4 WORDS) | TIM. PARTIAL. POINTERS 
PINFO PTRS (4 WORDS) | TIM, PINFO. POINTERS 

| SYNTH TYPE (ls WORDS) | TIM. SYNTH. TYP 
ee 
es PRE-COMPUTED DATA ! 

| MISCELLANEOUS AREA PTR | TIM.MISC, POINTER 
aaa ate TINFO PTR —~=S:sST'IM, TINFO. POINTER 


1 

' 

4 

' 

1 a a a a a 
H PRE-COMPUTED DATA 
= aa nen ens enema seeeh une anne em me ! 
i] 


FREE SPACE (BAL OF 1 SECTOR)! 


KEYBOARD LOOK UP TABLE 
(ONE SECTOR; NO LITERALS DEFINED) 


THIS REPEATS 


' PTR TO PATCH TIMBRE FRAME IN! } 

! ‘TIMBRE PARAMETER AREA |: } THREE WORDS 
| ann ' } PER KEY FROM 
! 0 IF MONO; 1IF STEREO { } CO TO C7: 

| anne ne 1 } = 85 KEYS 
PTR TO FILE BLOCK IN ! } ~- 255 WORDS 
! EXTERNAL OR POLY MEMORY |} TOTAL 

{ t 


TERMINAL DISPLAY INF 


The TERMINAL DISPLAY INF area is scratch space used by the 
terminal for generating informational displays. An area is 
established to store data matching that which is displayed on the 
screen. Then, as time passes, information inside the Synclavier 
software is compared with the copy of the displayed data. If and 
when the data differs from what is on the screen, the terminal must 
be updated. This way, time only needs to be spent re-drawing parts 
of the display that are out of date. This technique is only one of 
many uses of the TRD area for displays. 
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he. 


MONO SAMPLING BUFFERS 


A MONO SAMPLING BUFFER is created in external memory to hold 
sound files when they are loaded from disk for the FM synthesizer. 
This block is only created on systems having FM synthesis. The 
format of the data is almost identical to sound files stored in poly 
memory. | The MONO SAMPLING BUFFER is created with the smaller of the 
sizes: 


# 158 Sectors. 
# One half of all of external memory from the beginning up to the 
start of the LOOK UP TABLES. 


LOOK UP TABLES 


Some pre-computed LOOK UP TABLES are stored at the top of 
external memory, just under the swapping procedures. These include 
LOG, SINE and FREQUENCY tables. This saves the time of calculating 
the data during real-time Synclavier execution. A number of other 
blocks of information are stored here. Although not expanded further 
in this document, each block is named, shown in its relative position 
in upper external memory and the size in sectors is shown. For more 
information, see the file :SYNRSOU:08-INIT:600-INIT containing the 
procedure "SETUP. EXTERNAL.ALLOCATIONS", 
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LOOK UP TABLES 
MFM.PTR-->} FM TO MULTI-CHAN MAP (1) } 
J 


eA A CG A SS ON A CO EE EE A AD SNR OE SO 


1 
MPOLY.PTR-->; POLY TO MULTI-CHAN MAP (1) 
| een nnn nen ee 
USE, PTR=->j USAGE COUNTERS (1) 


! 
i 
' 
' 
' 
CLAV.PTR=->} KEYBOARD BITS (1) i 
| meena t 

TBUT.PTR-->} TRACK BUTTON TABLE (1) | 
1 
' 
' 
1 
i 
! 
i 
§ 
{ 


2 a A OS A NG NE EN TO NE NE EE IN SO ONY OI NT NN I 


1 
PBN.PTR=->} BUTTON LOOKUP TABLE (2) 
i 


0 A A SO HE NE SE SO SN HO I SD EH 


{ 
LOAD.PTR-->} SPACE TO HOLD LOADER (4) 


A st SN ET HD SO NO GE I NE ES SD NE NE A CR NN 


1 
KBD.PTR-->{} PRE-COMP KBD PTL BLKS (47) 
i 


A SA a ON: OD A LS LE AOE NS NS I OD RS ON SS I Sm 


ist entry 


NUL. PTR=->! NULL TIMBRE (1) : 
ING.PTR—->! SCREEN TMAGE (4) 
WMAP.PTR—>} MIDI VELOCITY MAP (2) | 
TINAP.PTR—>! TRANSIT TIME MAP (2) 
FREPTR—>! FREQUENCY TABLE (8) 
SIB.PIR—->} SINE TABLE (1)! 
LTB.PIR—>} LOG TABLE (4) | 

| KEYBOARD TIMBRE HEAD (1) {<> 

TINHEAD-—>! TIMBRE LOOK UP TABLE (1) 1+ 
! 


1 
TRK.HEAD-->} TRACK LOOK UP TABLE (1) i-=-+ 1st entry 
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Section 4 -- Poly Memory 


_ Poly memory is not directly addressable by the ABLE CPU. It is 
accessed as a device is through the use of XPL "read" and "write" 
statements. Because it is addressed using two registers totalling 24 
bits, it is possible to have a maximum of 32 megabytes of poly 
memory. This is in the process of being increased to 28 address bits 
allowing up to 512 megabytes of poly. 


Poly memory is divided into SECTORS of 256 words each. When 
accessing this memory,” the poly system must have the function code 
set to either read or write to poly memory. Then a single data 
register is used to specify the address and data. The data register 
must receive first the sector address, then the offset into the 
sector, and finally the data word(s). Poly memory accesses always 
cause an auto-increment after each one. 


POLY MEMORY 
DROLOP a2) eee er reer rere et ees + 
Offset -->!} SECTOR-0 (256 words) H 


0 CE CN AP AONE OH ND TE SES OD ER COND IE LN ET GO SO SO EN SO RS 


The values of all of the poly memory function codes are defined 
in :SYNLITS:FCODLITS. The following example reads the first 1024 
words of poly memory into an array in internal memory. Note that the 
procedures PSMREAD(MSB,LSB); and PSMWRITE(MSB,LSB); are usually used 
by the Synclavier software to set up the function code and address 
information. This means the first three statements could be replaced 
with "psmread(0,0);". 


write (PSF) = PSRMA; /* Set the poly system to read memory 
write(PSD) = 0; /* Point at the first sector */ 
write(PSD) = 0; /* No offset into the first sector */ 


do i=0 to 1023; 
array(i) = read(PSD); /* Read data word (and increment) */ 
end; 


OVERALL STRUCTURE 


Poly memory is primarily used for storing sound files. It is 
possible to load sound information into poly memory, exit the 
Synelavier program, return later and have the sound files still 
present. They are usually only removed when the space is needed for 
other sound files, on command by the user, or when the system is 
powered down. 
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J 


The system is in the process of being expanded to allow multiple 
poly bins to exist. Each one will have a maximum of 32 voices and 
512 megabytes of memory (former maximum was a single bin with 32 
voices and 32 megabytes of memory). Each bin has its own sound files 
loaded in it, and each bin is having data structured as shown below 
for one bin. aaa 


The first sector of poly memory is used to store a small header. 
The "MAGIC NUMBER" and "REVISION" at the start are zeroed out during 
sensitive transitions (eg: loading a new sound file; shuffling the 
existing sound files around) and restored when they are complete. 
This way, if a user manially aborts the Synclavier program while the 
oe ees are in transition, everything must be restored from 
the disk. 


POLY MEMORY BIN 
:SYNLITS : SAMPLITS 


20 SECTORS 
PSFIRST-—> | ----------=------------------ '<=-FIRST.BASE = 21 
SOUND FILE BLOCKS 
PSLAST <-> | eee naan nnn nn nnn nnn nn nena nnn 
FREE SPACE 
PSMAX=—> peann nnn nnn nnn mannan +<=-POLYAMOUNT 


POLY HEADER 


The POLY HEADER is stored in the first sector of poly memory. It 
keeps a "MAGIC NUMBER" which means valid data is present if the 
number is preserved. There are also pointers to the other key data 
structures. These pointers are important since the sound file 
information is preserved in poly memory even when the Synclavier 
program is exited. 


The two word pointers (MSB and LSB) are being created to support 


poly bins with greater than 32MB of memory. Older versions of the 
software use single word pointers for PSFIRST through PSHERE. 
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POLY HEADER 


See SO ON EE A EC SEE HOD SN LO SO SD SO ON SER I SO SU Ho 


(30071 OCTAL) 
(152077 OCTAL) 


A A A CNS EO NE CO ND AR ONE NS NS EE ARE SE SED OE OE a 


SE SC SE CER LO TORE GED AN SEND OU SD 2 EE LO MS NY SO SE ND NE NED NE HES A ED 


i 
1 
i 
H PSHERE: MSB, LSB H 
' ! 
' t 
; (BALANCE OF SECTOR UNUSED) | 


20 SECTORS 


Between the POLY HEADER and the SOUND FILE BLOCKS, there are 20 
sectors reserved. This is a seratch area used to store a _ sound 
sample that is displayed on the terminal for in-depth analysis. A 
user can examine this sample in detail (eg: mousing through parts of 
it forward, backward, at varying speeds...). 


SOUND FILE BLOCKS 


The rest of poly memory is reserved for SOUND FILE BLOCKS. These 
are data areas of varying length containing the digitized sound 
samples which can be played back through the poly synthesizer. There 
is one "special" SOUND FILE BLOCK. If the first word of the filename 
is a "1", rather than a printable ASCII character, the block is the 
SOUND FILE CACHE. This is a block of pointers to where all the sound 
files are stored on disk. 
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eS 


4) POLY MEMORY 


SOUND FILE BLOCK 


:SYNLITS:SAMPLITS 
BLOCK LENGTH 
NUMBER OF USERS 


FILENAME - 4 WORDS 


SN SE A SA A SS SE IE SE ED AD MN 


FREE SPACE 


BLK OF DATA MATCHING OFFSETS 
IN PATCH TIMBRE (PT.*) 


-28- 


1 BL.LEN = 0 
BL. USERS 


it 
oo) 


i] 

t 

i] 

i 

1 

| BL.FNAME = 2 
i 

' 

' 6 to 19 


BL.KEYTC = 20 to 


i 
i 
| BL.SAVED 
t 
' 
{ 


Hou 


He to 255 
1 


f 
! SF HDR 
! 


' 
| SF.SYM = 2 


BL.POLY = 1024 
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This is a block diagram of the Synclavier hardware system. 


Section 5 -~- Hardware Overview 


The 


direct-to-disk system in the lower right is expanded later on. 


‘Terminal | 


eee ce mn en ee, oS beteaheebeat 


fren eer ee 
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1 
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i 
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iMulti-Channel ; : 
; Distributor | : 
pote ne nn een nny ! 
1 ' 

i ' 

{ 1 

i 1 

J t 

{ 1 


v 
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sara + { MIDI |} 
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‘Interface! 


a Syne } 
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iH ! SMPTE } 
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<-----> |Floppies } 


t 

' 

' 

' 

t 
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H oy 
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_ ge=-SCSI-==4 


, aaa + 
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fe mer en ee, 


yi 
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DEVICES AND THEIR ADDRESSES 


The following devices are connected to the ABLE buss to support 
the full configuration shown in the previous diagram: 


D4567 - Multiply/divide (really D4,D5,D6,D7) 

D3 —- Real time clock (used to generate 5 msec interrupts) 
DT6 - Scientific timer (used to generate 1 msec interrupts) 
Be¥ - SCSI host adaptor 

P30TD - Kennedy 15mb cartridge tape drive 


B32X - Buss extender card containing: 
p32 - Multichannel distributor interface 
DI54-157 - Poly synthesizer interface 


D34 - Guitar and button panel interface 
P40Q - Combined serial port card containing: 
D4O - Printer port 
BES - Modem port 
BaF - Mouse port 
D50 - Terminal port 


D60 - External memory interface 


D7O - Combined interface address containing: 
D7+(8) - SMPTE interface 
D7O0=C16) - MIDI interface 


DIOOA - Floppies 
Dt30 - Clavier and button panel interface (velocity keyboard) 


DPT60 - FM synthesizer interface 
PI60 — Keyboard analog I/O interface (original keyboard only) 
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DIRECT TO DISK 


The direct-to-disk system connects to the main ABLE computer via 
the SCSI buss. It contains another ABLE computer which is the same 
as the main one except it does not boot from a floppy. The boot ROM 
is modified to receive data from the main ABLE over the SCSI; there 
are no floppies or winchester disks on the "Direct-to-disk ABLE", 


The Direct-to-Disk System 


4 


; Sa + 
poorer mime nimnensemenconeamem + iSound } 
To main ABLE CPU <----------- >: DIRECT-TO-DISK [<---=>{level | 
ScsI i ABLE CPU i MIDI {meter | 
Yara ibridge} 
5 aaa + 
i 
v 
sane i cebeete SE secant SR aa aoe re aan onan + 
i Tape {~~ | Disk | ~~ {Disk | --SCSI=~} iPoly Synthesizer | 
Sie A see cabelas 2 iBuffer j~~- 7 - «= = = H 
| ania a, eee ae conaiele iMemory {Sample-to-Memory | 
i Tape} ~~ {Disk | -~{Disk}--SCSI-~| PSE ie ae ae ee 
S oleiniee a cele a Sates 2 H iMemory (1-32Mb) | 
e eee een + 
° : 
. Vv 
Up to 8 pe ern co eee aoe + 
pairs of channels H 
each stored on one | AUDIO OUTPUT ; 
i ' 
t { 


or more disks 
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Appendix 


TERMINOLOGY 


This is a partial list of terms one is likely to encounter when 
reading through the Synclavier code. 


CHANNEL - A voice allocated in a synthesizer. There must be 
a channel available for each individual sound which occurs 
simultaneously. 


EXTERNAL MEMORY - Memory which is not immediately addressable 
by the ABLE CPU. It is accessed in sectors using 24 address 
bits and therefore may be up to 32 megabytes in (size. 
Sequences, timbres and other data is stored here. 


GHOST BLOCK - If a partial block is needed and none are 
available, a search is made to see if there are some decaying 
notes. A GHOST BLOCK is a partial block that is still in 
use, but is for a note which is decaying and will not be 
needed for long. Often, it is better to cut a decaying note 
short rather than avoiding starting a new note on time. 


INTERNAL MEMORY - Memory which is directly available to the 
ABLE CPU for instructions and data. Due to the 16-bit ~ 
address space in the processor, it is limited to 64K words. 


LIVE CLICK TRACK - A "metronome" recorded on a track, rather 
“than using the one supplied by the Synclavier. This allows 
for changes in tempo during a song. 


LOOPS - An overall loop may be established to cause all the 
tracks to loop between marked "start" and "end" points. An 
"independent" loop may be set up for a single track. 


MP INFO - Music printing info area; the "INF" section of 
external memory. 


NAH - NOTE AREA HEADER; a data structure in external memory. 
NLS ~ NOTE LIST SEGMENT; a data structure in external memory. 
ORK - The "ORiginal Keyboard" for the Synclavier II. It is 
the predecessor of the "Velocity Keyboard". It has 61 notes 
(C1 to C6). 
PATCH - When a sound files are divided so that different keys 


or ranges of keys on the keyboard generate sound from 
different samples. 
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PINFO AREA = An optional data area in the TIMBRE PARAMETER 
AREA in external memory. It contains extra partial 
information needed in some cases. 


POLY MEMORY - Memory which is part of the poly synthesizer, 
used primarily for storing sampled sound data. This memory 
is also addressed using 24 bits and may be up to 32 megabytes 
long. This is in the process of being increased to 28 bits 
and 512 megabytes. 


RIBBON ~ An effect controller located above the keyboard on 
some systems. As you’ slide your finger back and forth on the 
ribbon, an associated sound parameter can be modified. 


RTE - Real-time effects; selectable from the button panel on 
the keyboard. 


SECTOR - A block of memory or disk storage 256 words (512 
bytes) in size. External memory, poly memory and disks are 
accessed in sectors and 8-bit offsets within sectors. 


TIMBRE ~- A sound or set of sounds available to be played from 

the keyboard (or guitar). Typical timbres include drums, 
flute, trumpet, vibes... They are often produced from 
several samples of these instruments at different pitches and 
then "patched" together to cover the range of the keyboard. 
Or, in the case of percussion for example, different 
instruments may be on different keys. Timbres can also be- 
totally synthesized (eg: a sine wave) rather than samples of 
sounds, 


TINFO AREA - An optional data area in the TIMBRE PARAMETER 
ER in external memory. It contains special real-time 
effects information. 


USAGE KEY NUMBER -—- A checksum generated for a timbre which 

has a VERY VERY high probability of being unique (though not 
100%). Used to identify a timbre to see if it is already 
loaded without having to compare it bit-for-bit. 


VELOCITY KEYBOARD - The current Synclavier keyboard which is 
bo velocity and pressure sensitive. It is often refered to 
as the "New Keyboard". It has 76 notes (AO to C7). 


WESTERN SCALE - The "standard" 12-tone scale: C, C#, D, D#, 
oee AF, B. 


VOTCE ~- A channel allocated in a synthesizer. There must be 


a voice available for each individual sound which occurs 
simultaneously. 
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XPL TRICKS 


These are some of the more unusual constructs you will find when 
reading through the Synclavier code. 


-*core(0)" - This can be used as a literal definition, for 
example: 
DCL OVERALL.VOLUME LIT '"CORE(O)'; ~ 

This is sometimes done when a section of code containing a 
literal is conditioned out, but will not make it through the 
first passes of the compiler without SOME value. core(0) is 
not guaranteed to contain anything useful to most programs, 
so care must be taken not to actually use the value in real 
code. 


FREESRO; - This is a literal defined to be the (seemingly 
useless) code: 
IF 0 THEN WRITE("300") = READ("300"); 

This statment is optimized out by the third pass of the 
compiler. Its purpose is to trick the XPL compiler into 
thinking that RO ("300") has just been used. Then one can 
write some assembler code like "write("301") = a + b;" to put 
a value into Ri for some extra fast piece of code. Since the 
compiler always allocates registers using RO first, you know 
the addition of a and b will be done in RO, and R1 will be 
free for your use. 


- REMINDERS - Sometimes you will see "dead" code like: 

F POLY.SPLICE THEN DO; END; 
This is put in place as a reminder so that later you can find 
it to put real code in. By removing the literal definition 
of POLY.SPLICE compile errors will be generated if you forget 
to replace one of these constructs with real code. 


RPT nnn; - An XPL literal construct used with the Model-C (or 
newer) processor only. It causes the next single word 
instruction to be executed nnn times. The execution takes 
place in micro-code as “one instruction cycle" for the 
processor so it is not interruptable! Care should be taken 
not to make these loops too large (usually limited to RPT 
64;). It is FAST though. 


SWAPABLE - A literal defined as "RECURSIVE SWAP", Most 
swapping procedures in the Synclavier source are declared 
with this pseudo-keyword. Note that swapping procedures may 
NOT be called during an interrupt. 


REGISTER 13 - The code: 

~~ -WRITE ("313") = SOMETHING; 
is storing a number directly in register 13. XPL never uses 
R13, so it is available as a very fast variable within a 
procedure. 
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NOTE NAMES 


When notes are stored in the Synclavier software, they are 
generally numbered from 0 to 84 with #36 as "middle-C". This is 
convenient since 85 keys is (3 * 255). The keyboard look up table 
for example is three words per key and fits in one sector of external 
memory. It is also seven full octaves C-C. The keys are named as 
follows: 


NOTES NUMBERED 
€o - BO 0 - 11 
C1 - Bl 12 - 23 
C2 - B2 24 = 35 
C3 - B3 36 - 47 
C4 = BY 48 = 59 
C5 - BS 60 - 71 
C6 - B6 72 - 83 
C7 84 


Sometimes other designations are used for notes and pitches. 
MIDI uses keys numbered from 1 to 127 where 60 is "middle-C". 


"Pitch class numbers" use numbers of the form "0.SSCC" where "oO" 
is the octave (corresponding to the octave numbers in the table 


‘above, eg: A3 is in octave 3), SS is the semi-tone (0 to 11) and CC 


is the number of cents (hundredths of a semi-tone). Using this 
notation, "3.0900" would be "A3" (A at 440 Hz); "3.0000" would be 
"C3" ("middle-C" or C at 523.3 Hz). 


The original keyboard has a range of 61 notes from C1 to C6. The 
new velocity keyboard is 76 notes from AO to C7. 
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